Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / ds300.arc / DS_READ.ME < prev next >

Wrap

Text File | 1987-06-05 | 22.9 KB | 417 lines

DIRECTORY SCANNER PROGRAM Ver 3.00 /// Users of Ver 2.30 (and earlier) updating to Ver 3.00 MUST (repeat \\\ *** MUST) use the new version of DS_DRIVE.SYS contained herein. *** \\\ Ver 3.00 will not work correctly with older versions of DS_DRIVE.SYS /// Presents a full screen display of the directory structure of a given disk drive. The display looks like the following: █████ Drive C ███████████████████████████████ C:\DIR2 ████████████████████████ █ c:\ █ backup .exe ║ finder .com ║ guts .zzz █ █ ├─ dir1 █ create .com ║ finder .exe ║ help .def █ █ ├─ dir2 █ dump .asm ║ finder .obj ║ killer .com █ █ │ ├─ sub1 █ dump .exe ║ guts .asm ║ print .com █ █ │ └─ sub2 █ dump .obj ║»guts .com« ║ qsort .exe █ █ └─ dir3 █ eater .bas ║ guts .exe ║ vdisk .sys █ █ █ eats ║ guts .obj ║ zoo .bas █ █ █ eatz .bat ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ ███████████████████████████████████████████████████████████████████████████████ Total: 10,456,123 │ Help=? Name ^ │ Files: 22 Used: 137,354 Tagged: 0 Used: 8 000,000 │ Free Core 146K │ ────name──── ──size── ──date─── time─ atr Free: 2,456,123 │ Disk 80% Full │ guts .com 17,123 10 Aug 85 18:30 r ------------------------------------------------------------------------------- | This program consists of the following 9 files: 1. DS_READ.ME - This read.me file 2. DS_DRIVE.SYS - File loaded as a device driver that reserves 10K of memory to store hard disk directory structure information. This memory area is used so that upon reactivation of "DS.EXE", repeat scanning of the disk is not needed to determine the disk directory structure. This file REQUIRES the following entry in your "CONFIG.SYS" file: DEVICE=DS_DRIVE.SYS D:C ^^^--- Drive specifier where D:C indicates only drive C will be maintained by the driver. or D:CD indicates drives C & D will be maintained by the driver. Note: Currently only a max of 2 drives may be specified. If you have only 1 HD drive to save, it's highly recommended that you specify that 1 drive so that the device driver will allocate all of its reserved memory area for that one drive. It is recommended that you do not specify floppy disk drives or RAM drives here as they take little time to rescan the full drive directory structure. The above entry is required in your "config.sys" file so that upon booting your system, the file is loaded as a device driver. Upon successful booting and loading of this file you should see the following message: | "DSCANNER Drv 3.00 Installed" This file is MANDATORY for the program to operate correctly. Without this file the DS program must seek out the entire hard disk directory structure each time the program is activated. This disk directory structure scan can take upwards of 10 seconds to accomplish on a 10M hard disk. Even longer for larger and fuller hard disks. With this file installed at boot time the DS.EXE program can maintain directory data on up to 2 drives. If you will be using the "b" backup option of the DS program the "ds_drive.sys" MUST be installed at boot time as the backup option expects to obtain data from the installed | driver. Other program modules (ie: F10 - expanded help | option, macro definitions, and directory links) also | REQUIRE the device driver to be installed to work | correctly. Don't call me with questions if you haven't | installed this driver. 3. DS.EXE - The directory scanner program. Can be executed by typing the following: "ds" - Start program on the default drive. If the DS_DRIVE.SYS memory area has been loaded and contains directory structure information then rescanning of the disk for the directory structure info is not necessary. "ds c" - Start program with "c" drive as the first displayed drive. This format is also used if it becomes necessary to rescan the disk directory structure and avoid using possibly outdated directory structure information contained in the DS_DRIVE.SYS driver memory area. There is an option within the DS program (ALT-R) to rescan the drive and update the directory structure information so that exiting and re-entering DS with "ds c" is not necessary. 4. DS_BKUP.EXE - The backup program which is activated from within the DS program by selecting the "b" option. This program is not a self sufficient program. It cannot be executed on its own and work properly. It expects to obtain directory structure information from the DS_DRIVE.SYS memory area. The DS_BKUP.EXE program must reside in a directory in your PATH. 5. DS_HELP.EXE - The expanded context-sensitive help displays. The program is activated from within the main program by pressing the F10 key. | 6. DS_INIT.EXE - This program is called by the main ds program to aid in | displaying/changing macro definitions, the default editor | and lister, and the directory to number linking. | 7. DS_PROG.DEF - The program "defaults" file. This file contains data on | the default startup colors, macro definitions, the | defined editor and lister, and links of directories to | numbers. | 8. DS_USERS.MAN - An abbreviated users document. 66 lines/page (19 pages) 9. DS_MOUSE.MSC - Source file for a Mouse Systems optical mouse device driver pop-up menu display. RECOMMENDED "AUTOEXEC.BAT" ENTRIES: To enable automatic startup of the program on color monitors the fol- lowing sample entries are recommended for the user's autoexec.bat file. | path c:\;c:\dos;c:\ds;... {"c:\ds" plus other user directories} dpath {shareware dpath program } | set DS=c:\ds {sets home directory of ds files } ds {starts execution of DS program } Assumptions in using the above entries are: 1. The DS program files are housed in the "c:\ds" directory. 2. The user has a copy of the "dpath" shareware program which enables DOS to find overlay and support files the editor may need. If the user has sufficient memory and maintains a RAM disk, startup time for the DS or the user-supplied editor may be reduced if the user copies ds.exe and/or their editor to the RAM disk and includes the RAM disk as the first directory in the path command. | REQUIRED "CONFIG.SYS" ENTRY: | | The following line is REQUIRED in your "congif.sys" file for the PROPER | OPERATION AND INTERFACING OF DS PROGRAM MODULES: | | device=c:\ds\ds_drive.sys D:CD | | Use the full pathname appropriate to your system and where you placed | the "ds_drive.sys" file. See the discussion above on file #2 for an | explanation of the "D:CD" parameter as it also should be appropriate to | your system configuration. CURRENT PROGRAM LIMITATIONS: MS/PC DOS 2.0+ Maximum number of fixed/hard disk drives supported/saved: 2 NOTE: Floppy and RAM drives are supported by the program but not saved to the ds_drive.sys area unless instructed to by a command in the config.sys file. See the discussion of the ds_drive.sys file above. Maximum number of directories per drive: 100 Maximum number of files per directory: 250 Maximum length of full pathname for any directory: 39 characters These limitations were chosen for no particular reason. The program can be recompiled extending these limitations, but with a consequent increase in the size of the program. The program currently takes up | approximately 70K during execution. This does not include the backup option (which during execution takes up additional core - but releases it upon termination of the option), nor does it include the ds_drive.sys device driver which permanently reserves an area in low memory. PROGRAM BACKGROUND: The "directory scanner" program did not start out to be the DOS shell program it is now. Originally, I started out to write a hard disk backup program to enable backing up and (more importantly) restoring the hard disks on PC's located in public rooms in the Computer Science Department of the Naval Academy. The midshipmen had tendencies to add/delete files they shouldn't and occasionally even use the dreaded "format c:" command, so procedures for quick backup and restoration were necessary. As the backup program took shape I recognized it had capabilities far beyond just backup and restoring files. Development of the backup program was therefore temporarily suspended while the DOS shell program took shape. Many early suggestions for improvement came from the other instructors within the CS department. When the shell program firmed up, work was completed on the backup program and it was installed as the "b" option within the directory scanner program. The program is written primarily in "C" (90%) with a number of supporting assembly languages routines (10%) used to enhance display speed. REVISION HISTORY: (Major Changes or enhancements) Ver 2.00 - Initial public release Ver 2.10 - Added CTRL-L option to show program limits. Also added limit checks to detect excessive directories/files and inform user of problem. Offending directories/files are ignored and program continues execution. - Added ALT-F option to show free space on drives other than the current drive. - Increased stack size in an attempt to eliminate sporadic stack overflow errors in file sort routine. - Bug Fix. Copy/Move option with destination directory of only 2 or 3 characters (ie: \c or \ds) did not work correctly. Ver 2.11 (27 May 86) - Temporary patch to file sort routine stack overflow problem. - Added ALT-X option to allow execution of indicated file with I/O redirection possible. Original "X" option did not allow for redirection. - Modified DS_DRIVE.SYS device driver to allow the user to specify the drives the driver should save. This will allow users with other than fixed disks (Bernoulli boxes for example) to specify their desires. See above explanation on DS_DRIVE.SYS for proper specification of desired drives. Ver 2.12 (29 May 86) - Bug Fix to backup option introduced by Ver 2.11 where backup option listed 1 file in each directory twice and left off 1 file that was really there. Ver 2.20 (20 Dec 86) - Changed Rescan Directory option (old CTRL-D) to ALT-R option to make room for next new option. - Added CTRL-D option for Directory Modifications. Allows addition, deletion, and name changing of directories. Based on limited testing to date, name changing only appears to work for PC/MS DOS 3.0+. - Added ALT-S option for Selecting & Sorting of files within a directory. Allows the user to specify a file select filter other than the default "*.*". Also allows for sorting files up/down by filename, extension, size, date, or no sort (directory order). - Installed new sort function to rectify previous stack overflow problems with original sort routine. - Added CTRL-V option to toggle the displaying of disk volumn identifiers. Ver 2.21 (3 Jan 87) - Fixed bug in backup option. New sort routine added in version 2.20 caused backup program to crash if diskette or drive directory identified as backup destination was empty. If backup option is not used, version 2.21 is identical to version 2.20. Ver 2.30 (1 Feb 87) - Deleted F10 as an exit option to make room for the next new option. - Added expanded on-line context-sensitive help. The F10 key is used to activate this option. - Modified "c" command enter option to allow for multiple command entries prior to returning to DS. Also allows for interface with DOS command stack/editing programs such as "CED", and keyboard redefinition programs such as "Newkey". - Modified find option to display only matching files in directories where matches occur. Changed option keys in a directory with a matching file to F2 (continue search), CR (stay in current directory), & ESC (return to original directory). - Added "TAB <ltr>" option to enable tabbing/moving to the first directory containing a matching letter as the first character in its full pathname. * Acknowledgement - Grateful appreciation is extended to Mr. James Lemay of Ft. Worth, Texas for his careful review and thoughtful insights and suggestions for improvements to the program. | Ver 3.00 (8 Jun 87) | | - Modified Color Change options. Alt-K must be selected | to enable color changes. This prevents accidental | color changes which was annoyingly common in previous | versions. Along with this change the "set DS=0F14" | type command in the "autoexec.bat" file must be | replaced with a | "set DS=c:\ds" (without quotes) | | type command. The characters following the equal sign | should specify the full pathname of the directory where | the user has placed all the DS files. The pathname of | the specified "home" directory should NOT end with a | "\" so if the user places all DS files in the root | directory of the "d:" drive, it would be specified as | follows: | "set DS=d:" (without quotes) | | - Added Alt-E option to enable toggling in and out of EGA | 43-line mode. | | - Added support for macro definition and execution. Alt- | F1 thru Alt-F9, Shift-F1 thru Shift-F9, and Ctrl-F1 | thru Ctrl-F9 may be user defined to execute other | DOS commands. Alt-F10, Shift-F10 and Ctrl-F10 are used | to display/change macro definitions. Should future | desired enhancements require some available keys, one | set of the above keys (ie: all alternate-function keys) | may be freed up for such purposes. | | - Add capability to link a directory to a number key or | alt-number key sequence. After such linkage is made, | depressing the single number key or alt-number key | sequence will switch the directory display to the new | directory. Selecting "0" or "alt-0" will display | directory links and allow additions/deletions. | | - Added Ctrl-E option to enable user to define desired | editor and lister program. Defaults are "edit" and | "list" but may be permanently changed by the user. | | - Added "defaults" file support to provide for permanent | user changes to most of the previous options. | | - Remember to change the "set DS=0FBb" entry in your | "autoexec.bat" file to reflect the full pathname of the | home directory for all the DS files. | ie: "set DS=c:\ds" if the user has placed all the DS | programs in the "c:\ds" directory. | AUTHOR: Nat Martino | 501 W. Vineyard Ave. #514 | Oxnard, CA 93030 | (805) 485-6340 Personal Biography: Sep 67 - Jun 71 Graduated from UC Berkeley with AB in Geography also commissioned an Ensign in the Navy thru NROTC. Jul 71 - Aug 73 Naval aviation basic and advanced training at Pensacola FL, Glynco GA, and Whidbey Island WA. Aug 73 - Feb 76 VAQ-132 EA-6B squadron. The Navy's tactical electronic warfare aircraft. (1st tour) Feb 76 - Dec 77 Naval Postgraduate School, Monterey CA. MS degree in computer science. Jan 78 - May 80 Office of the Chief of Naval Operations (OP-643F) Data base administrator for CNO operational readiness reports & automated support for Navy Command Center. Jun 80 - Dec 80 VAQ-129 readiness training squadron. Jan 81 - May 83 VAQ-137 EA-6B squadron. (2nd tour) May 83 - Jun 86 U. S. Naval Academy. Computer Science Instructor Jul 86 - present Pacific Missile Test Center, Pt Mugu CA. Software Support for EA-6B aircraft. LICENSING/REGISTRATION | A $15 contribution is requested for the use of this program to | help support the author support the program. After having spent | thousands of hours of my own time to provide users with the | simplest, most logical, straight forward and useful disk management | and DOS shell program, I am requesting that users participate in | supporting the program throught the small requested contribution. | The contribution will enable procurement of equipement (such as a | printer, mouse, expanded memory, etc.) to expand the capabilities | and usefulness of the program. See the users' manual or on-line | registration help screen for full details on licensing.